From 310179176ccbca609aad3174f6714b4abb04748b Mon Sep 17 00:00:00 2001 From: =?utf8?q?S=C3=A9bastien=20Wilmet?= Date: Sun, 15 Sep 2013 01:07:36 +0200 Subject: [PATCH] Improve doc of gtk_text_buffer_paste_clipboard() It didn't explain the behavior when there is a non-empty buffer selection. https://bugzilla.gnome.org/show_bug.cgi?id=339539 --- gtk/gtktextbuffer.c | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/gtk/gtktextbuffer.c b/gtk/gtktextbuffer.c index de91b756b3..852b464e8a 100644 --- a/gtk/gtktextbuffer.c +++ b/gtk/gtktextbuffer.c @@ -3764,14 +3764,16 @@ remove_all_selection_clipboards (GtkTextBuffer *buffer) * gtk_text_buffer_paste_clipboard: * @buffer: a #GtkTextBuffer * @clipboard: the #GtkClipboard to paste from - * @override_location: (allow-none): location to insert pasted text, or %NULL for - * at the cursor + * @override_location: (allow-none): location to insert pasted text, or %NULL * @default_editable: whether the buffer is editable by default * - * Pastes the contents of a clipboard at the insertion point, or - * at @override_location. (Note: pasting is asynchronous, that is, - * we'll ask for the paste data and return, and at some point later - * after the main loop runs, the paste data will be inserted.) + * Pastes the contents of a clipboard. If @override_location is %NULL, the + * pasted text will be inserted at the cursor position, or the buffer selection + * will be replaced if the selection is non-empty. + * + * Note: pasting is asynchronous, that is, we'll ask for the paste data and + * return, and at some point later after the main loop runs, the paste data will + * be inserted. **/ void gtk_text_buffer_paste_clipboard (GtkTextBuffer *buffer, -- 2.30.2